table.REFRESH Function

Syntax

L Refresh()

Description

Perform network refresh, return True if changed.

Discussion

The <TBL>.REFRESH() method refreshes the data in the record buffer for the current record in the table referenced by <TBL>. This method is typically used when you have multiple Xbasic scripts operating on the same table, or you have a script that opens a particular table more than once. It ensures that the data in the record buffer for a particular record is not stale.

Example

The following Interactive Window session demonstrates when to use the <TBL>.REFRESH() method.

t1 = table.open("customer")
t2 = table.open("customer")
t1.recno() ? 1.000000
t2.recno() ? 1.000000
'delete the record in t1
t1.change_begin()
t1.delete()
t1.change_end(.T.)
't2 still points to record number 1
t2.recno() ? 1.000000
't2 indicates that the record is not deleted because the record buffer is stale
t2.is_deleted() -> .F.
'the .need_refresh() method confirms that t2 has a stale record buffer
? t2.need_refresh() -> .T.
'refresh t2's record buffer
t2.refresh()  
'now, the record is shown as Deleted
t2.is_deleted() -> .F.
't2's record buffer is not stale
t2.need_refresh() -> .F.

Here is another example.

'Both instances of the table point to same data
t1.Lastname -> "Cario          "
t2.Lastname -> "Cario          "
t1.change_begin()
'Change t1 to "Jones"
t1.Lastname = "Jones"
t1.change_end(.T.)
't1's record buffer is stale. It still has "Cario"
t2.Lastname -> "Cario"
t2.need_refresh()-> .T.
t2.refresh()
t2.lastname -> "Jones"
t2.need_refresh()-> .F.
t2.close()
t1.close()